home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / wterm107.arc / WTERM.DOC < prev    next >
Text File  |  1991-03-30  |  36KB  |  751 lines

  1.          ┌──────────────────────────────────────────────────────┐
  2.          │                                                      │
  3.          │   \/\/term  (C)Copyright \/\/alter Cox 1990, 1991.   │
  4.          │                All rights reserved.                  │
  5.          │                                                      │
  6.          │               \/\/term  DOCumentation                │
  7.          │                                                      │
  8.          │                    Version 1.07                      │
  9.          └──────────────────────────────────────────────────────┘
  10.  
  11.  
  12.          Introduction
  13.  
  14.          WTERM is a bare bones comm program that should be
  15.          adequate for use with most bulletin boards.  Users with
  16.          limited disk and/or memory may find it especially
  17.          useful.  There is no script language and no terminal
  18.          emulation.  There is no built-in ANSI support so you
  19.          must load an ANSI driver in your CONFIG.SYS file.
  20.  
  21.          There is no scrollback buffer, however WTERM writes a
  22.          file named WTERM.LOG and strips ANSI from it.  You can
  23.          use LIST to view this file and aside from the slight
  24.          delay to load it, it works better than a scrollback
  25.          buffer with search capabilities.  The log can be toggled
  26.          on and off if you desire.  More on this later.
  27.  
  28.          No file transfer protocols are built-in.  WTERM relies
  29.          on external protocol drivers like DSZ (tm) and PCZ for
  30.          file transfers.  DSZ is shareware and PCZ is Public
  31.          Domain.  The Zmodem upload and download strings are
  32.          detected automatically.  The Zmodem driver you have
  33.          configured is then called.
  34.  
  35.          A 16550AN UART is automatically detected and activated
  36.          with the FIFO trigger level set for 8.
  37.  
  38.          An editor of your choice may be configured and loaded at
  39.          the touch of a function key.  A few good free editors
  40.          are EDWIN, Turbo Powered Editor(TPE), and VDE.  For a
  41.          tiny free editor, you might want to take a look at TED
  42.          by PC Magazine.  Another fine shareware editor which
  43.          many seem to be using is Qedit (tm).
  44.  
  45.  
  46.  
  47.          Setup
  48.  
  49.          WTERM has an internal setup utility.  If no WTERM.CFG
  50.          file exists when WTERM loads, it automatically loads
  51.          setup and will not let you out of it until you write a
  52.          setup file.  When you wish to view or change the
  53.          configuration, press ALT-S.  Use the capital letter
  54.          associated with any parameter to change that parameter.
  55.          First press U and enter your name.  This is the name
  56.          that will be transmitted by WTERM when you press the F2
  57.          key.  A line will appear in reverse video showing how
  58.          many characters are allowed for this entry.  Enter your
  59.          name and press enter.  An enter will be appended to the
  60.          name automatically.  In the next line, configure the
  61.          drive, path and filename of the editor you wish to use.
  62.          See the section below on line editing for an
  63.          explaination of how the line editor works.
  64.  
  65.  
  66.          Setup - Modem
  67.  
  68.          Port, Speed, pArity, Bits, and sTopbits are all toggles.
  69.          Press the capital letter for a given entry to select the
  70.          value you desire.
  71.  
  72.          Modem initialization string also uses the line editor.
  73.          To send an enter (carriage return) use |.  For a one
  74.          second pause, use a ~.  If you have been using another
  75.          comm program, use the modem initialization string you
  76.          used for it.  The initialization string included in the
  77.          example works with my modem but is mainly there to fill
  78.          the space and give an example.  There are too many
  79.          modems out there to come up with one string that works
  80.          for all and no attempt has been made to do so.  Consult
  81.          the manual that came with your modem for the proper
  82.          commands.
  83.  
  84.          HST users NOTE:  The HST has trouble loosing it's
  85.          initialization after an ALT-H, so sending the
  86.          initialization afterwards was added for it.  A delay was
  87.          also needed, so you may need to add one or two "~" in
  88.          front of the initialization string.
  89.  
  90.          When a connection is made, WTERM looks at the CONNECT
  91.          string returned and tries to switch to the speed of
  92.          connection.  Some users of fast modems wish to lock
  93.          their comm port at a higher rate and let their modem
  94.          switch to the speed of the line.  Lockbaud set to on
  95.          will prevent WTERM from changing the port speed.  If set
  96.          to no, it will set the port to the speed of the connect.
  97.  
  98.          You may configure a dialing prefix, the string WTERM
  99.          will send to the modem before sending the number to
  100.          dial.  Users with Hayes compatible modems with touchtone
  101.          phones will not have to change the default ATDT.  If
  102.          your line only supports pulse dial, change it to ATDP
  103.          instead.  You may add a | in front of the dialing prefix
  104.          to make sure the command is seen by the modem as the
  105.          first characters in a line.
  106.  
  107.          WTERM has both Xoff/Xon and hardware (RTS) flow control.
  108.          The F key toggles from None, to Xoff/Xon, to Hardware,
  109.          to both and back to none.  Flow control works only one
  110.          direction.  It prevents the modem from overrunning it
  111.          but doesn't pay attention to CTS to prevent overruning
  112.          the modem.  Since keyboard input isn't fast enough to
  113.          overrun anything and ASCII transmits can use the pace
  114.          character timing, it shouldn't be needed.  Users of
  115.          modems faster than 2400 baud should set hardware flow
  116.          control.
  117.  
  118.  
  119.          Setup - Protocols
  120.  
  121.          WTERM detects the start of a Zmodem download or upload
  122.          and calls the protocol you have configured.  If you
  123.          chose to use a protocol other than Zmodem, you can turn
  124.          this option off by setting autoZmodem to no.  If this
  125.          feature is desired, leave it at the default yes.
  126.  
  127.          The next option, asCii pace time, sets the number of
  128.          msecs. between characters transmitted with an ALT-T
  129.          transmit or with an ALT-M message upload.  You can set
  130.          this time between 0 (no delay) and 999 msec. - very
  131.          extreme.  Adjust this speed if the boards you use have
  132.          difficulty with your speed of transmission.
  133.  
  134.          Options 1 and 3 set the drive and path for your default
  135.          up and download directories.  When you begin an upload,
  136.          WTERM changes to the directory you enter in 1.  For a
  137.          download it switches to the drive and directory you have
  138.          configured in 3.  Using this option and the %S (speed)
  139.          and %P (port), you can set up your protocol (such as
  140.          PCZ) to up and download without using batch files.  See
  141.          the section on file transfers below for more
  142.          information.
  143.  
  144.          Option 2 sets up the external protocol driver used for
  145.          an upload.  Enter the name of the program and any
  146.          options needed.  When WTERM detects the start of a
  147.          Zmodem upload, it checks to see if the last filename it
  148.          saw is in the upload directory.  If it is, it does not
  149.          prompt for a filename but immediately starts the upload.
  150.          If you press PgUp before the upload starts, it prompts
  151.          for a filename and adds the name of the last file seen
  152.          as a default which you can edit, or just hit return to
  153.          start the upload.  The name of the default directory to
  154.          be used is displayed in the filename prompt, the one
  155.          configured in 1.  It can be overridden by specifing the
  156.          path.  This of course assumes that you have not set
  157.          autoZmodem to no.  If your protocol driver is not in
  158.          your path or in your upload directory, make sure you
  159.          enter the drive and path as well.  If you need to tell
  160.          the driver the port and speed, use %P for port and WTERM
  161.          will replace it with the port in use.  Speed works the
  162.          same way.  Add %S and it will be replaced by the current
  163.          speed.  This allows the same string to work at multiple
  164.          speeds.  While you can use batch files to load the
  165.          driver, hopefully you will not have to with the options
  166.          available to you.
  167.  
  168.          The download string (4) works the same way the upload
  169.          string works.  It does not prompt for a filename since
  170.          the sender sends the filename to the receiver (with
  171.          Zmodem).
  172.  
  173.          NOTE:  In early versions of WTERM, you needed to add a
  174.          trailing backslash to the paths to the up and download
  175.          directories.  This backslash is no longer needed.  Enter
  176.          the drive and path exactly as you would if you were
  177.          doing a CD (change directory).  This is exactly what
  178.          WTERM does before calling the drivers.
  179.  
  180.          PgUp will call up the driver configured as the upload
  181.          protocol as though a Zmodem upload string had been
  182.          detected.  It prompts for a filename.  PgDn calls up the
  183.          download protocol and does not prompt.
  184.  
  185.          External protocol menu programs can be installed on one
  186.          of the ALT-Function keys as a DOS command to give you a
  187.          choice of protocols.  One I used with ProComm was POE
  188.          (Procomm Outside Environment) and it worked well on a
  189.          WTERM function key.  Thought was given to adding such a
  190.          thing internally to WTERM but since some users (like me)
  191.          use Zmodem exclusively, it was left out to make WTERM as
  192.          small as possible.
  193.  
  194.  
  195.          Setup - switching pages, Writing the configuration or
  196.                 quit.
  197.  
  198.          The bottom line of both setup pages displays a help
  199.          line.  The spacebar switches between the two pages of
  200.          setup.  W, Write, saves the current configuration to the
  201.          configuration file WTERM was loaded with.  Escape quits
  202.          setup without saving the changes, although they are
  203.          active for the current session.
  204.  
  205.  
  206.          Setup - Page 2, Function keys
  207.  
  208.          Function keys F4 through F8 are strings you can enter
  209.          that will be transmitted at the touch of the function
  210.          key.  As with the modem initialization string, a | will
  211.          cause an enter to be transmitted and a ~ will generate a
  212.          one second pause.
  213.  
  214.  
  215.          Setup - DOS Commands
  216.  
  217.          Up to five DOS commands can be configured using ALT-F1
  218.          through ALT-F5.  Enter the commands the way you would if
  219.          you were at the DOS command line.  Once configured,
  220.          WTERM will run the command when that function key is
  221.          pressed.  After the command finishes, WTERM displays a
  222.          "Pause...".  Press any key when you wish to return to
  223.          WTERM.  The screen is then restored as it was before the
  224.          command was run.
  225.  
  226.  
  227.          Setup - Misc.
  228.  
  229.          WTERM can sound an alarm when a connection is made.
  230.          Connect tone can be set to the tone that will be
  231.          sounded.  Setting it to 0 will disable the option.  The
  232.          tone you enter will be sounded five times.  Start with
  233.          something like 1100 and adjust the tone to your liking.
  234.          The higher the tone, the higher the frequency sounded
  235.          etc.
  236.  
  237.          BIOS writes can be enabled and disabled.  If you run DV
  238.          and have a bleed through problem or if you have CGA and
  239.          have a snow problem, toggle this option to Y.
  240.  
  241.  
  242.          Line Editor
  243.  
  244.          The line editor used in WTERM for the dialing directory
  245.          entries and the setup strings, has several options.  A
  246.          ^K will Kill the current entry so that you can start
  247.          over again.  Left and right arrows work as you would
  248.          expect, to position the cursor to the place you wish to
  249.          make a change.  You may insert and delete characters.
  250.          When in insert mode, the cursor is made larger.  Tab or
  251.          Escape quits editing without any changes while enter
  252.          saves the changes.  The field you have to work in is
  253.          black on white in the default color configuration but
  254.          may be changed with the debug color scripts.  If you
  255.          change the colors, make sure the editing colors are
  256.          noticeable with the colors you have selected.
  257.  
  258.          Note:  Make sure you don't add extra spaces to the end
  259.          of a string.  WTERM will not remove them and they can
  260.          cause you trouble in some fields.  The End key will stop
  261.          at the end of the string as will the right arrow key.
  262.  
  263.  
  264.  
  265.          Using multiple CFG and DIR files
  266.  
  267.          You can specify a drive and path for the .CFG and .DIR
  268.          files that WTERM will use by using command line options.
  269.          To specify a .CFG file in other than the default directory,
  270.          use a command line option of:
  271.  
  272.                 WTERM -C[drive][path]filename
  273.  
  274.          For a different phone directory use the -F option
  275.  
  276.                 WTERM -F[drive][path]filename.
  277.  
  278.          Once in the dialing directory, you can load another
  279.          directory with Alt-L.
  280.  
  281.  
  282.          File Transfers
  283.  
  284.          The only provision for binary file transfers is through
  285.          the use of external protocol drivers.  Either DSZ (tm)
  286.          or PCZ is recommended. Other protocols can be used as
  287.          well but you should turn off the autozmodem option if
  288.          you do.
  289.  
  290.          Set up the external protocol by doing an ALT-S from the
  291.          terminal screen, as explained above.  WTERM will pass
  292.          the current speed an port settings.  To pass the port,
  293.          use %P; speed is %S.  WTERM will expand the % variables
  294.          to the proper value when executing the command line.  A
  295.          simple example of a Zmodem download using COM1 - COM4
  296.          could be written like so:
  297.  
  298.                          DSZ port %p speed %s rz
  299.  
  300.          DSZ defaults to the correct speed so it is not necessary
  301.          to use speed on the command line.  You can also set an
  302.          environment variable for the comm port - SET DSZPORT=2.
  303.          Having done that, the above command line could be
  304.          reduced to:
  305.  
  306.                                  DSZ rz
  307.  
  308.          PCZ however defaults to 2400 baud.  To make the command
  309.          line work at all available speeds, use of the %S
  310.          parameter is necessary.
  311.  
  312.                                PCZ 1 %s rz
  313.  
  314.          PCZ's command line looks much line DSZ except that the
  315.          words "speed" and "port" are optional.  You can hardcode
  316.          the port as in the above example or use %p since your
  317.          modem normally stays on the same port.
  318.  
  319.          You should be able to call most any protocol driver
  320.          directly without the use of batch files, but batch files
  321.          can be used if necessary.
  322.  
  323.          Much could be written on interfacing protocol drivers
  324.          but that is beyond the scope of this DOC file.  Read the
  325.          DOC that comes with the protocol driver you are going to
  326.          use and it should provide enough information to write
  327.          the proper command lines.
  328.  
  329.          WTERM checks incomming data for valid filenames and
  330.          saves the last filename found.  If you are in autoZmodem
  331.          mode and WTERM detects the Zmodem upload string, it
  332.          checks the upload directory to see if the last filename
  333.          seen exists.  If it does, the filename prompt is skipped
  334.          and an automatic upload started.  This will cause
  335.          problems with batch uploads since only the last filename
  336.          will be uploaded.  You can either turn off autoZmodem in
  337.          setup or hit the PgUp key before receiving the Zmodem
  338.          upload string.  When this key is used, WTERM will pop up
  339.          the filename prompt with the name of the last file seen.
  340.          You can kill the filename with ^K if you want or hit
  341.          enter if the correct filename was chosen.  PgUp does not
  342.          do auto uploading and gives you a chance to change the
  343.          filename or add additional filenames if desired.
  344.  
  345.  
  346.  
  347.          ASCII Transfers
  348.  
  349.          The ALT-T (Transmit an ASCII file) and ALT-R (Receive an
  350.          ASCII file) are intended for use in uploading and
  351.          downloading messages.  The ALT-T command strips
  352.          linefeeds from the file and expands a blank line to a
  353.          space carriage return.  A small delay is built-in after
  354.          sending a carriage return (about 3 msec.).  This command
  355.          can only be used online.  I did this because I tried it
  356.          offline and confused the heck out of my modem.
  357.  
  358.          The ALT-R receive a file is mainly intended for use with
  359.          the ALT-M option explained below.  It strips ANSI
  360.          commands for incoming text.  This mode is automatically
  361.          turned off when the ALT-M command is executed.
  362.  
  363.          WTERM has pace character timing as an option.  You can
  364.          set the time between characters from 0 to 999 msec.
  365.  
  366.          When using the ALT-M option, a check will be made for
  367.          carrier before doing the upload.  If no carrier is
  368.          detected, WTERM assumes you are not online and does not
  369.          do the upload.
  370.  
  371.  
  372.  
  373.          Operation
  374.  
  375.          F1 displays a Help screen.  Hit any key to resume and the
  376.          screen will be restored.  The following functions may be
  377.          found on the help menu:
  378.  
  379.          ALT-X  eXit WTERM back to DOS
  380.          ALT-J  Jump to DOS
  381.          ALT-H  Hangup
  382.          ALT-C  Clear the screen
  383.          ALT-D  Dialing directory
  384.          ALT-N  Exit the program leaving DTR and RTS high
  385.          ALT-M  Message reply online using your own editor
  386.          ALT-R  Receive an ASCII file to WTERM.MSG
  387.          ALT-S  Setup utility
  388.          ALT-T  Transmit an ASCII file
  389.          PgUp   Transmit a file using DSZ Zmodem
  390.          PgDn   Receive a file using DSZ Zmodem (in case Auto Zmodem
  391.                 dosn't work)
  392.  
  393.          F1     Help Menu
  394.          F2     Transmit your name
  395.          F3     Transmit your password
  396.          F4-F8  Transmit string from .CFG file
  397.          F9     Load LIST for file viewing
  398.          F10    Load your Editor
  399.  
  400.  
  401.  
  402.          The Dialing Directory
  403.  
  404.          Press Alt-D from the terminal screen to enter the
  405.          dialing directory.  All 20 entries in a directory are
  406.          displayed.  Additional directories can be loaded with
  407.          the Alt-L command.  The box at the bottom of the screen
  408.          is a help/status line. It will show you that you can
  409.          scroll the scrollbar with the up and down arrow keys and
  410.          get more help by using the left and right arrow keys.
  411.          Once you dial, the line becomes a status line, showing
  412.          you what board you are currently dialing and the seconds
  413.          until redial.  Add S7=45 to your modem initialization
  414.          string to make it accurate.  When you get a connect or a
  415.          busy etc., the status line shows you the string returned
  416.          by the modem such as CONNECT 2400 or BUSY.  In the Que
  417.          mode, it will countdown five seconds and dial another
  418.          number.  There is a clock at the lower right side of the
  419.          screen.
  420.  
  421.          Here are the commands available to you in the dialing
  422.          directory:
  423.  
  424.          Escape   Escape will return you to the terminal mode.
  425.                   If you are dialing, escape will abort the dial.
  426.          Up and down arrows  Scroll the scrollbar to select an
  427.                   entry.
  428.          Left and right arrows  Scroll through the help lines in
  429.                   the help/status line.
  430.          Home     Move the scrollbar to the first entry.
  431.          End      Move the scrollbar to entry 20.
  432.          Alt-P    Toggle the display of Passwords on and off.
  433.                   The default is off.
  434.          Alt-L    Load another dialing directory.  You will be
  435.                   prompted for the name of another directory to
  436.                   load.  The name of the directory currently
  437.                   loaded will be displayed in the center of the
  438.                   line above the box.  The size allowed for the
  439.                   filename will be displayed in white.
  440.          Alt-E    Edit an entry.  The entry the scrollbar is on
  441.                   will be edited.  Escape or tab will skip a
  442.                   field leaving it unchanged.  Enter will clear
  443.                   the field.  A white box (this can be changed
  444.                   with the color and mono batch files) will
  445.                   define the width of the field.
  446.          1 - 0    Hot keys to dial entry 1 through entry 10.
  447.          Shift 1 - 0   Hot keys to dial entry 11 through 20.
  448.          Q        Que mode.  Que and the number of queued entries
  449.                   will be displayed in the center of the line
  450.                   above the help/status line.  An entry is queued
  451.                   by selecting it with the scrollbar and pressing
  452.                   the spacebar.  To unque a single entry, press
  453.                   the spacebar again.  Que mode is automatically
  454.                   turned off when making connection with the last
  455.                   entry on que.  A checkmark is displayed beside
  456.                   the entry number for entries queued.  Once a
  457.                   connection is made, if there are other entries
  458.                   queued, WTERM looks for NO CARRIER and the
  459.                   carrier detect signal to drop.  When it sees
  460.                   this, it switches back to the dialing directory
  461.                   and starts the 5 second pause and then dials
  462.                   the next number in the que automatically.  Once
  463.                   the que is built, you can go through the entire
  464.                   que without manually dialing again.
  465.          C        Clear all entries on que and quit que mode.
  466.          Enter    Dial the entry at the scrollbar or start que
  467.                   dialing.  If you are in the que mode but no
  468.                   entries are queued, the current entry is
  469.                   queued.
  470.  
  471.          The default name for the dialing directory is WTERM.DIR.
  472.          The parameter field should contain the speed, parity,
  473.          bits per character and number of stop bits the entry
  474.          should be dialed at.  For 2400 baud, no parity, 8 data
  475.          bits and 1 stop bit, you should enter 2400N81.  Speeds
  476.          through 19200 are supported.
  477.  
  478.          Once you have created the dialing directory, select an
  479.          entry and hit enter to dial it.  When you get to the
  480.          name prompt, F2 will send your name as you have it in
  481.          the configuration file.  At the password prompt, F3 will
  482.          send the password you have entered for that entry.
  483.  
  484.  
  485.  
  486.          Log file
  487.  
  488.          WTERM opens a log file when a connection is made.  ANSI
  489.          is stripped from the data written to the file.  You may
  490.          view the log at anytime if you have LIST configured by
  491.          pressing ALT-L.  The file will be saved until another
  492.          connection is made, at which time it is reopened with
  493.          the old contents destroyed.  This keeps the log file
  494.          from growing.
  495.  
  496.          You can toggle the log on and off with ALT-O.  Just be
  497.          aware that if you turn it off, you lose the ability to
  498.          view text that has scrolled off your screen.  Floppy
  499.          users may want to turn it off and find a PD scrollback
  500.          program.  While there is no option in setup to save the
  501.          On/Off status, it can be saved by going into setup and
  502.          just saving it to disk.  The next time you load Wterm,
  503.          it will then remember weither to turn it on or off.
  504.  
  505.  
  506.  
  507.          Respond to messages and quote them using your own full
  508.          screen editor locally
  509.  
  510.          The ALT-M command works in conjunction with ALT-R to
  511.          allow you to quote a message and respond to it locally
  512.          using your own full screen editor and then automatically
  513.          upload the reply while still online.
  514.  
  515.          To use it, once you find a message to which you would
  516.          like to respond and quote, type ALT-R.  This will open a
  517.          file named WTERM.MSG and any characters received are
  518.          written to it.  ANSI is stripped out.  Display the
  519.          message again so that it is captured to the file.  Then
  520.          hit ALT-R again.  ALT-R is a toggle and hitting it the
  521.          second time will close the file.
  522.  
  523.          At this point you start your reply just like you
  524.          normally would.  After entering to TO and the SUBJECT
  525.          and get to the point you would start entering your
  526.          message, hit ALT-M.  WTERM then captures the timer tick
  527.          interrupt and installs a program that keeps the board
  528.          from timing out.  It first sends a message to the sysop
  529.          which the user will not see which says "Editing message
  530.          offline.  Please wait...".  This lets the sysop know
  531.          what is going on while you are in your editor.  It then
  532.          sends a space a half a second later and in another half
  533.          second, a backspace.  This is done the entire time you
  534.          are in your editor.  PCBoard(tm) will not time out with
  535.          this routine (it would with the backspaces only as it
  536.          use to be).
  537.  
  538.          After the space/backspace routine is installed it shells
  539.          to DOS and bring up your editor editing WTERM.MSG.  If
  540.          you used ALT-R to copy the message into WTERM.MSG, you
  541.          are ready to start editing your message - picking out
  542.          what you wish to quote and writing your response.  I
  543.          not using ALT-R and using the .LOG file myself.  If you
  544.          do this, WTERM.MSG will be the last message you sent.
  545.          Clear the editor and read in WTERM.LOG.  Mark the start
  546.          of the message and go to the end, then page back to the
  547.          start of the message you wish to quote or respond to.
  548.          Mark the start of that message and kill from that point
  549.          back to the start of the file.  Then go to the end of
  550.          the message and kill from that point to the end and you
  551.          are now ready to start your quotes and response.
  552.          Reformat for line length and add the ">" to it.  A
  553.          editor that can do macros is useful here.
  554.  
  555.          Once you exit your editor, you are put back into WTERM,
  556.          and the space/backspace routine is removed.  There is a
  557.          short delay while a string of backspaces is sent to
  558.          remove the sysop message to keep it from becoming a part
  559.          of your message.  The screen is then restored and your
  560.          message is automatically uploaded.  If it gets garbled
  561.          with noise, quit and start your reply again and then do
  562.          an ALT-T and enter WTERM.MSG as the filename and upload
  563.          it again.
  564.  
  565.  
  566.  
  567.          Jumping to DOS
  568.  
  569.          When you jump to DOS using ALT-J, the comm port remains
  570.          active.  Assuming the receive buffer doesn't overflow,
  571.          when you return to the program, the screen will be
  572.          restored and data received while in the shell will be
  573.          displayed.  While you are in the shell, the DOS prompt
  574.          is changed to the current drive and path enclosed in
  575.          curly brackets.  The F1 key is reassigned using ANSI so
  576.          that pressing it will cause it to send EXIT and you will
  577.          be returned to WTERM.  Of course you can also type EXIT
  578.          to return.  You don't have to change back to the
  579.          directory WTERM is in before you type EXIT.  WTERM
  580.          always changes the default directory to it's own.  If
  581.          it is loaded from another drive it will change to its own
  582.          drive and directory.  Just add the WTERM directory to
  583.          your path and you can load it from any drive and
  584.          directory on your system.
  585.  
  586.  
  587.  
  588.          Exiting WTERM
  589.  
  590.          There are two ways to exit WTERM.  By using ALT-X, you
  591.          are returned prompted whether you really want to quit or
  592.          not.  Hit Y or enter to quit.  N clears the prompt and
  593.          leaves you in WTERM.  When you exit, the comm port is
  594.          reset and the controls are turned off.  This will cause
  595.          the modem to hangup if you are connected.
  596.  
  597.          To exit WTERM with the controls left high, use ALT-N.
  598.          If you enter WTERM again while still connected, it
  599.          detects carrier and will not send the modem init string.
  600.          This allows you to exit to DOS and have all of your RAM
  601.          to do with as you wish.
  602.  
  603.  
  604.  
  605.          Color Configuration
  606.  
  607.          WTERM colors can be configured using DEBUG scripts
  608.          included in this package.  MONO.SCR is included for
  609.          users with monochrome monitors.  While this is not the
  610.          most convenient way of doing this, it does save space
  611.          and programming and helps keep WTERM small.  The
  612.          following files have to do with colors:
  613.  
  614.          COLORS - gives the default colors, codes, and locations.
  615.          WTCOLOR.BAT - a batch file to run DEBUG and take the
  616.                 script file COLOR.SCR as input.
  617.          COLOR.SCR - the default color configuration that can be
  618.                 edited with an ASCII editor to colors of your own
  619.                 choice.  COLORS gives information you will need
  620.                 to make your selections.
  621.          WTMONO.BAT - a batch file to run DEBUG and take the
  622.                 script file MONO.SCR as input.
  623.          MONO.SCR - a script file that sets the colors to black
  624.                 and GRAY or WHITE for use with monochrome
  625.                 monitors. Acknowledgement
  626.  
  627.  
  628.          Acknowledgements
  629.  
  630.          After looking at several C source comm routines, I chose
  631.          the one used from a file named COMM.ZIP by Mario
  632.          Grannini. It was modified in several places but still
  633.          retains a good bit of his work.  It is a good example of
  634.          C programming and was easily modified for use with
  635.          WTERM.
  636.  
  637.          My thanks to Roland Brown, world famous author of Opus
  638.          Message Kit (OMK) for his help and encouragement
  639.          (nagging :-)), ideas, and beta testing.  He got a chance
  640.          to get back at me for my "help" with OMK here.
  641.  
  642.  
  643.          WTERM Utilities
  644.  
  645.          PC Magazine published a program named SNIPPER.  This
  646.          program is a TSR (Terminate and Stay Resident) program
  647.          that allows you to mark off a block of text on your
  648.          screen and save it to a buffer, to disk, or print it.
  649.          Others have modified and improved upon it.  It has
  650.          proven to be useful for BBS use in quoting messages.
  651.          The latest version I could find was version 2.2.  I
  652.          modified this version for was use in quoting with WTERM.
  653.          It adds "> " to the start of each line and saves to a
  654.          file with a default name of WTERM.MSG.  The original
  655.          version always appended to this file.  I modified it to
  656.          and gave the user the option of appending or of creating
  657.          a new file with only the latest block of text.  When
  658.          used in the file mode, either Append or File, and saved
  659.          to WTERM.MSG it is especially useful in writing messages
  660.          using your own full screen editor (ALT-M option).  Your
  661.          editor is loaded with the text you have quoted already
  662.          in it.  For boards with editors fast enough to handle
  663.          the speed, you can save to the buffer and do a Get when
  664.          ready to insert the quote.  On boards that can't handle
  665.          the speed, you will have to use the ALT-M mode which
  666.          does an ASCII upload.  This program is named
  667.          WT-QUOTE.ZIP and includes the ASM source code.
  668.  
  669.          PCZMOUSE  PCZMOUSE is a Logitech (MS compatible) mouse
  670.          menu for use with Wterm.  PCZ is an external protocol
  671.          driver that can add several protocols including Zmodem
  672.          to any comm program and is PD.  With this menu and PCZ,
  673.          WTERM can have the following protocols: Xmodem,
  674.          1K-Xmodem, Ymodem, Zmodem, and Sealink.  The source for
  675.          this menu as well as Daryl's below is included so you
  676.          can combine the two easily if you desire or use either
  677.          or none.
  678.  
  679.  
  680.  
  681.          WTERM utilities by other authors
  682.  
  683.          Thanks to Daryl Martin, a mouse program is included.
  684.          Daryl gave his permission to do so.  I left his file
  685.          exactly as I received it.  UnZip it and give it a try if
  686.          you have a mouse.
  687.  
  688.          Tom Collins wrote a program that makes setting the
  689.          colors much easier.  The name of the program is
  690.          WTC105A.ZIP.  While I am not sure it will save the
  691.          status of BIOS writes and the log toggle, you should be
  692.          able to use it and then get in WTERM, set the logger on
  693.          or off, set BIOS writes to Y if you desire and save the
  694.          configuration.  Perhaps Tom will come out with a WTC106
  695.          now if it doesn't work.
  696.  
  697.  
  698.          Legal Stuff
  699.  
  700.          DSZ mentioned above is shareware and is not free
  701.          software.  If you use it, you should register it and pay
  702.          the reasonable $20 registration fee.  LIST is free for
  703.          personal use though the author does except
  704.          contributions.  Both programs are copyrighted by their
  705.          authors.  PCZ is public domain and copyrighted.  SNIPPER
  706.          is copyright PC Magazine.
  707.  
  708.  
  709.          While a license is freely granted for use of this
  710.          program, I do retain a copyright and reserve all rights
  711.          to it.  You may not charge for WTERM.  The only
  712.          exception to this is for computer clubs.  They may
  713.          charge up to $3.00 plus actual postage for a diskette
  714.          containing WTERM.  WTERM can not packaged with any
  715.          product or sold by shareware disk dealers.
  716.  
  717.          No version of WTERM is to be distributed in modified
  718.          form.  Distribute it exactly as is.  The only exception
  719.          to this is that boards wishing to include their boards
  720.          in the dialing directory may do so IF they do not remove
  721.          the boards that are already in it.  Those people helped
  722.          with WTERM development and rightfully deserve to be
  723.          there.
  724.  
  725.          Since this is a free program and I gain nothing from it,
  726.          I also assume no responsibility should you decide to use
  727.          it.  Although it seems to work fine on my AT compatible,
  728.          it may not work on your system.  You assume all
  729.          responsibility for ANYTHING that happens if you choose
  730.          to run WTERM.  By running it, you agree to these terms.
  731.  
  732.  
  733.          Support
  734.  
  735.          None.  If you feel you need support, look at some of the
  736.          fine user supported software on the boards.  The reason
  737.          you do not see an address or phone number in this file
  738.          is because I do not wish to support a free program.  I
  739.          certainly will not return long distance calls on my
  740.          dime.  If you happen to know me, DO NOT ATTEMPT TO CALL
  741.          ME AT WORK!   My employer is paying for my time and I
  742.          owe it to him.   I will be less happy with you than he.
  743.          For the most part you are on your own.  Feel free to ask
  744.          questions in the local BBS message areas where I can
  745.          respond at my leisure.  If you use it in your business,
  746.          hire someone to support it.  Don't expect me to do it
  747.          for free.  Sorry, but this is a hobbyist effort and I
  748.          don't want it to go further than that.
  749.  
  750.          \/\/alter Cox
  751.